package com.asialjim.wechat.apiservice;

import com.asialjim.wechat.pojo.user.WeChatUser;

/**
 * <h1><em>ASIAL JIM JAVA DOC</em></h1><hr/>
 * <h2>INTERFACE DESCRIPTION <i>[ NAME: WeChatUserService ]</i></h2><strong>
 * <p> we chat user service
 * </strong><p><p><em>Copyright &copy; Asial Jim Co., LTD</em><hr/>
 *
 * @author Asial Jim &nbsp;&nbsp; <span>Email:<a href="mailto:asialjim@hotmail.com">asialjim@hotmail.com</a> &nbsp;&nbsp; <a href="asialjim@qq.com">asialjim@qq.com</a></span>
 * @version 1.0.0
 * @since 2021/3/16   &nbsp;&nbsp; JDK 8
 */
public interface WeChatUserService extends ApiService {

    /**
     * <h3>METHOD DESCRIPTION <i>[ NAME: weChatUserInfo ]</i></h3>
     * get we chat user info from ten cent service
     * @param openId {@link String open id}
     * @return {@link WeChatUser we chat user}
     * @author Asial Jim &nbsp;&nbsp;<span>Email:asialjim@hotmail.com &nbsp;&nbsp; asialjim@qq.com</span>
     * @since 2021/3/16 16:57
     */
    WeChatUser weChatUserInfo(String openId,String subjectId);

    WeChatUser weChatUserInfo(String openId);

    /**
     * <h3>METHOD DESCRIPTION <i>[ NAME: unSubWeChatUser ]</i></h3>
     * act when we chat user un subscribe your application
     * @param fromUserName {@link String user name}
     * @author Asial Jim &nbsp;&nbsp;<span>Email:asialjim@hotmail.com &nbsp;&nbsp; asialjim@qq.com</span>
     * @since 2021/3/18 17:09
     */
    void unSubWeChatUser(String fromUserName);
}
